home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / conct305.zip / BRUCE305.DOC next >
Text File  |  1993-05-19  |  17KB  |  362 lines
  1. BRUCE305.DOC
  2. 05/19/93
  3.  
  4. This documentation provides some overview information on a number of utilities
  5. that have been posted by Wayne Software.  All programs described herein were
  6. written by Bruce Guthrie.  Most are distributed with a Wayne Software copyright.
  7. Others were written for the U.S.  Department of Commerce.  All are free for use
  8. provided relevant documentation is kept with the programs, no changes are made
  9. to the programs or documentation, and they are not bundled with commercial
  10. programs or charged for separately.  READ (but not READMAKE and READINIT) and
  11. CONVERT are excluded from the commercial packaging restriction.
  12.  
  13. People who need to bundle AV, BFIND, DIRTOTAL, FILL, MULTICOL, NETSORT, or
  14. READWK in commercial packages other than shareware/freeware collections must pay
  15. a $50 registration fee to "Wayne Software" at the following address.  Comments
  16. and suggestions can also be sent to:
  17.  
  18.                 Bruce Guthrie
  19.                 Wayne Software
  20.                 113 Sheffield St.
  21.                 Silver Spring, MD 20910
  22.  
  23.                 fax: (301) 588-8986
  24.  
  25. The utilities are uploaded with a ZIP name that includes the year and month of
  26. the release.  These names are:
  27.  
  28.          AVymm.ZIP        AV program
  29.          BFINDymm.ZIP     BFIND program
  30.          CHANGymm.ZIP     CHANGE program
  31.          CONCTymm.ZIP     CONCAT program
  32.          CONVRymm.ZIP     CONVERT program
  33.          DIRTOymm.ZIP     DIRTOTAL program
  34.          FILLymm.ZIP      FILL program
  35.          FILUPymm.ZIP     FILUPDAT program
  36.          FIXCHymm.ZIP     FIXCHARS program
  37.          MULCOymm.ZIP     MULTICOL program
  38.          NETSOymm.ZIP     NETSORT program
  39.          READymm.ZIP      READ program (with READINIT and READMAKE)
  40.          READWyym.ZIP     READWK program (with READINIT)
  41.  
  42. This collection of utilities were compiled using Microsoft's VisualBASIC for DOS
  43. 1.0 compilers.  In each case, Thomas G.  Hanlin III's excellent PBClone routines
  44. provided additional functionality.  Each of the utilities are separately
  45. described in a like-named *.DOC file.  This documentation (BRUCEymm.DOC--the
  46. file release date is indicated by the "ymm" parameter) serves to summarize what
  47. the various utilities consist of.
  48.  
  49. Several of the routines have defaults that can be changed by the program
  50. CONFIGWS.EXE which is included in the appropriate ZIP's.
  51.  
  52. Wayne Software also writes programs, batch files, and sets up menu systems for
  53. people on a for-fee basis.  If you desire this service, contact Wayne Software
  54. at the address specified above.
  55.  
  56.  
  57. --------------------------------------------------------------------------------
  58.  
  59. A summary of each routine follows.  See the associated *.DOC files for fuller
  60. explanations:
  61.  
  62. AV.EXE:  Archive directory viewer.  Presents list of files in archive (ZIP, ARC,
  63. etc) and lets you sort as desired.  Syntax:
  64.  
  65.     AV filespec [ /-P | /P ] [ /Ox | /O-x ] [ /? ]
  66.  
  67. BFIND.EXE:  Allows Boolean-type FIND requests.  For example, find any line with
  68. one string AND another one, or any line with one string OR another.  The syntax
  69. shown below is limited since "search" allows a lot of choices.
  70.  
  71.     BFIND [ /V | /-V ] [ /C | /-C ] [ /N | /-N ] [ /I | /-I ] [ /P | /-P ]
  72.       [ /-HEADER | /HEADER ] { search } infile [ /? ] [ >filename ]
  73.  
  74. CHANGE.EXE:  Processes change commands in files.  Files can be of any size and
  75. type (e.g.  binary or text) and are processed quickly.  Up to twenty-five change
  76. commands can be processed in a single pass.  Also provides ability to remove
  77. trailing spaces from text files.  Syntax:
  78.  
  79.     CHANGE filename [ commandfile | /FROM string /TO string [ /IN search ] ]
  80.       [ /LINES { line1-line2 | line1 linect } ... ] [ /V | /-V ] [ /I | /-I ]
  81.       [ /Noutfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] ]
  82.       [ /Fflag_file ] [ /Ttemp_file ] [ /TRIM | /-TRIM ]
  83.       [ /BINARY | /TEXT ] [ /VERIFY | /-VERIFY ] [ /Q ] [ /? ]
  84.  
  85. CONCAT.EXE:  Concatenates a series of files together.  Can use wildcards or an
  86. input file.  Syntax:
  87.  
  88.     CONCAT [ filespec | @filespec | [drive:]filespec+ ] outfile
  89.       [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  90.       [ BINARY | /TEXT [ /CRLF ] ] [ /LRECL=nnn [ /BLKSIZE=nnnn ] ]
  91.       [ /NAMED ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  92.  
  93. CONFIGWS.EXE:  Lets you change some of the defaults for some of the programs.
  94. Syntax:
  95.  
  96.     CONFIGWS [ routine ] [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /? ]
  97.  
  98. CONVERT.EXE:  Converts between data formats:  FROM dBase, ASCII-delimited
  99. (commas between fields and quotes around strings), and fixed field TO Lotus WKS,
  100. ASCII-delimited, dBase, and fixed field.  Syntax:
  101.  
  102.     CONVERT infile [ outfile [ deffile ] ]
  103.       [ /OVERWRITE | /-OVERWRITE | /APPEND | /OVERASK ]
  104.       [ /DEF=deffile ] [ /FROM { FIXED | ASCII | ASCII=char | DBF } ]
  105.       [ /FIXED | /ASCII | /ASCII=char | /DBF ] [ /USEDEF | /NODEF ]
  106.       [ /TO { FIXED | ASCII | ASCII=char | WKS | DBF } ] [ /HEADER | /-HEADER ]
  107.       [ /SKIP | /MISSING | /ABORT ] [ /SAS ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  108.  
  109. DIRTOTAL.EXE:  Prepares report showing files in subdirectory or drive.  Allows
  110. some restriction requests (show only files with date greater than a certain
  111. value).  Similar to Norton's FF and Ray Van Tassle's WIZ command (which is a
  112. great program but it doesn't work on network or CD-ROM discs) in some ways but
  113. presents a more formal report.  Syntax:
  114.  
  115.     DIRTOTAL [ [ drive: ] ... [drive:][filespec] |
  116.         [ drive: ] ... [drive:]\path[\filespec] ]
  117.       [ /NL ] [ /S { GT | GE | LT | LE | EQ | NE } value ]
  118.       [ /D { GT | GE | LT | LE | EQ | NE } mm/dd/yy ]
  119.       [ /ATTR=attr ] [ /Ffilename ] [ /SPLIT ] [ /SUB | /-SUB ]
  120.       [ /Z ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  121.  
  122. FILL.EXE:  Program designed to fill up floppies with the maximum number of files
  123. that will fit into them.  "FILL *.BAS" will move *.BAS files onto a floppy,
  124. taking the biggest files first.  When it can't fit a file, it will skip it and
  125. move the next one.  Syntax:
  126.  
  127.     FILL [ source-filespec ] [ dest-drive: | dest-drive:\path\ ] [ /MOVE | /COPY ]
  128.       [ /OVERWRITE | /-OVERWRITE | /OVERSKIP | /OVERASK ] [ /PROMPT | /-PROMPT ]
  129.       [ /Ox | /O-x ] [ /Xfilespec ]... [ /WIPE | /-WIPE ] [ /MULTI | /SINGLE ]
  130.       [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  131.  
  132. FILUPDAT.EXE:  Program which compares a selected list of files in a source path
  133. against those in another path and copies those that have been updated.  Similar
  134. to DOS' REPLACE command but works from a stored list of files and can handle any
  135. number of directories.  Syntax:
  136.  
  137.     FILUPDAT control_fil
  138.       [ /Flist_file [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] ]
  139.       [ /FULL ] [ /ALL ] [ /Q ] [ /? ]
  140.  
  141. FIXCHARS.EXE:  Program which removes non-standard print characters from a text
  142. file.  Translates graphics characters into their ASCII equivalents.  Also
  143. expands tabs and removes backspaces.  Is primarily intended for people who have
  144. problems printing a file.  Syntax:
  145.  
  146.     FIXCHARS infile { outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] |
  147.       /REPLACE } [ /BINARY | /TEXT ] [ /Ffilename ] [ /-EJECT ] [ /Q ] [ /? ]
  148.  
  149. MULTICOL.EXE:  Program creates multiple column listings from straight ASCII
  150. text, ASCII-delimited text, or dBase files.  Also does subtotalling.  Syntax:
  151.  
  152.     MULTICOL infile outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ]
  153.       [ /DELIM="string" ]
  154.       [ /LINES=n ] [ /WIDTH=n ] [ /EJECT | /-EJECT ]
  155.       [ /COLUMNS=n ] [ /WRAP | /-WRAP [ /INDENT=n ] | /REFLOW ]
  156.       [ /Ccontrol_file ] [ /SETUP="string" ] [ /RESET="string" ]
  157.       [ /{ TITLE | HEADER | FOOTER }[ R | C | L ][ 1 to 5]="text" ]
  158.       [ /{ TITLE | HEADER | FOOTER }{ T | B }="string" ]
  159.       [ /FROM ASCII | /FROM ASCII=char | /FROM DBF ] [ /DEF=deffile ]
  160.       [ /SKIP | /MISSING | /ABORT ] [ /GAP=n ] [ /USEDEF ] [ /TALLY ]
  161.       [ /SUM={ col_spec | var_spec } ] [ /BREAK={ col_spec | var_spec } ]
  162.       [ /PRINT={ col_spec | var_spec } ] [ /? ]
  163.  
  164. NETSORT.EXE:  Slow but effective method for sorting files on a Banyan (and
  165. possibly other) server.  Syntax:
  166.  
  167.     NETSORT [ path ] [ /S ] [ /Ox | /O-x ] [ /BEEP | /-BEEP ] [ /? ]
  168.  
  169. READ.EXE